package com.tianji.promotion.service;

import com.tianji.common.domain.dto.PageDTO;
import com.tianji.promotion.domain.po.UserCoupon;
import com.baomidou.mybatisplus.extension.service.IService;
import com.tianji.promotion.domain.query.UserCouponQuery;
import com.tianji.promotion.domain.vo.CouponVO;

import java.util.List;

/**
 * <p>
 * 用户领取优惠券的记录，是真正使用的优惠券信息 服务类
 * </p>
 *
 * @author author
 * @since 2025-03-29
 */
public interface IUserCouponService extends IService<UserCoupon> {

    /**
     * 列出所有优惠券VO
     * @return
     */
    List<CouponVO> listVO();

    /**
     * 用户按优惠券id领取优惠券
     * @param id
     */
    void receiveCoupon(Long id);

    /**
     * 分页查询优惠券
     * @param ucQuery
     * @return
     */
    PageDTO<UserCoupon> pageQuery(UserCouponQuery ucQuery);

    /**
     * 通过兑换码兑换优惠券
     * @param ecode
     */
    void exchangeByCode(String ecode);
}
